home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Libraries / SAT 2.3.8 / Demos / HeartQuest demo ƒ / HeartQuest 1.0 docs < prev    next >
Text File  |  1996-06-25  |  8KB  |  115 lines

  1.  
  2.                                                  HeartQuest 1.0
  3.  
  4.  
  5. HeartQuest is a simple, fairly non-violent color arcade game for the Mac that I made as a gift to my wife. If your wife doesn't like it, perhaps your kids will.
  6.  
  7. The first version, b/w only, was made on Valentine's Day 1992. A week before Valentine's 1993, I released the colorized version, which was verison 0.7.
  8.  
  9. Improvements from 0.7:
  10. • The game doesn't get harder as fast. Level 5 was close to impossible before. Now things get harder in a nicer rate. Fewer hearts per level also means less slowdown on slower Macs (e.g. MacPlus).
  11. • A clicking sound warns you that you are getting low on bonus.
  12. • Bonus object should not appear too low any more.
  13. • Flypapers are used up after catching the player.
  14. • Faster "safe" graphics.
  15. • The mouse control is modified. Better? Well, that's up to you.
  16. • Some improvements in the graphics.
  17. • The underlying sprite library (Sprite Animation Toolkit) is safer than before, less likely to crash.
  18. From 0.8 to 0.8.1:
  19. • Smaller size. (Removed 30k caused by a stupid drawing program.)
  20. • Strings in the high scores are truncated so that the score won't be overwritten.
  21. From 0.8.1 to 0.8.2:
  22. • Preference file handling (making it CD-ROM-friendly).
  23. • Clicking in the game window starts or resumes the game.
  24. • No strings are hard-coded, so the program can be localized for other languages only by editing resources.
  25. To 0.9:
  26. • Bonus levels.
  27. • Fixed the "click to start level" box, which was too small.
  28. To 0.9.1:
  29. • In "normal mode", when a bonus object is running, the bonus does not decrease and the level does not end even if all hearts are taken. (My little nephew wants a chance to catch bonus objects even if he collects all heart first.) Macho mode is still the "hard" way.
  30. To 0.9.2:
  31. • Fixed a bug in the preference file handling. (It was never created.)
  32. To 1.0:
  33. • Fat binary (as if it needed it…).
  34. • Bug fix in the fading routines to eliminate a slowdown in animation that they introduced.
  35. • Another bug fix in fading routines (which previously had problems with more than 256 colors).
  36. • Displays a message while loading.
  37.  
  38. HeartQuest is *not*:
  39. ==================
  40. Violent.
  41. Slow.
  42. Expensive.
  43. Hard to learn.
  44. Big. (≈240k as fat binary)
  45.  
  46. How do I play HeartQuest?
  47. =======================
  48. In HeartQuest, you control a butterfly with the mouse, collecting hearts while trying to avoid the sticky flypapers. That's about it. Start by selecting "new game" in the "Game" menu.
  49.  
  50. The faster you do it, the more bonus you will get. The game has two modes, normal mode and macho mode. In normal mode, the game ends after three levels. In macho mode, the game is over whenever you run out of bonus. The normal mode is recommended for beginners, children, and anyone who doesn't have the hand-to-eye coordination or who don't like to do the game in a hurry.
  51.  
  52. Sometimes - I'm not saying exactly why and when, that's up to you to find out - you will get bonus levels. In those, a bunch of hearts fall down, and you should try catching as many as possible before they all are gone.
  53.  
  54. Color, you say. What bit depth? Will it work on a 68000 Mac (SE, Classic)?
  55. ==================================================================
  56. It works best in 1, 4 or 8 bits of color (grays are ok too) - and in all other depths as well, but in other screen depths, it might be a bit slow. It works on old, 68000-based Macs as well - at least my SE. Note, however, that an 8 MHz Mac can be quite slow on high levels.
  57.  
  58. Why make a game like this?
  59. =========================
  60. I made this game as my Valentine's Day gift for my wife Eva in 1992. The first version was a quick hack on that very day. Later, I have developed fast direct-to-screen routines, and I used HeartQuest for testing them. The whole thing eventually became Sprite Animation Toolkit, a game programming library.
  61.  
  62. Hey, I have seen several other games that work exactly this way!
  63. ==========================================================
  64. Quite true. The reason is that the source code to HeartQUest is available as part of Sprite Animation Toolkit. Most of the similar games are based directly on HeartQuest's source code. There is at least two games that are EXACTLY HeartQuest, where only the graphics has been changed. I have nothing against these "clones" as long as they give credit to their origin - which most do.
  65.  
  66. Hm, I suppose you have only tested it on your own Mac...?
  67. ==================================================
  68. HeartQuest has been tested on quite a bunch of Macs (SE, LC, IIfx, IIsi, Quadra 950, PB180, PB180c, LC475, PowerMac 6100/60…), under System 6.0.7 and 7. Of course there can be bugs, and of course there are some video cards or screen types that it isn't tested on, so I make no guarantees. Still, it seems to work pretty well.
  69.  
  70. Will there be any future versions?
  71. or
  72. Do the flypapers have to look like potato peels?
  73. =============================================
  74. If you are more of an artist than I am, you are welcome to make better-looking icons and backdrops. If you do, please send them to me for inclusion in a new version, or - if it's not intended to replace the old graphics, but rather to be an alternative - make it *absolutely* clear that your version is a "hacked" version - neither a "new" version or a different game. If the code hasn't changed, don't change the version number. (Of course, if you are a programmer who creates a completely new game based on the HeartQuest source code, then it's a different matter.)
  75.  
  76. There are two major problems when trying to improve the graphics:
  77. - Since the game can scale after other screen sizes (see below) a pixel mapped backdrop may look very ugly in some cases. I want scalable graphics.
  78. - A pixel mapped image takes *lots* of disk space. Simple games should take reasonable amounts of disk space. At less than 120k, I believe HeartQuest is where it should. Feel free to plug in other backdrops if you like. The source code is part of Sprite Animation Toolkit, freely available.
  79.  
  80. Why don't you use the full screen?
  81. ==============================
  82. I do, but only if you explicitly ask for it. Try starting the game with a modifier key (e.g the alt/option key) held down… but if your screen is big, you might have to give HeartQuest a lot more memory. This is only tested on 640*480 pixels - no guarantees!
  83.  
  84. What does that voice and the text on that bonus object say?
  85. =====================================================
  86. Yes, that's swedish, and I don't say anything important, just "yes!" and "that's it!", and the bonus object says "Eva is sweet". BTW, feel free to edit that text (with ResEdit) if you want to make a little surprise to *your* girlfriend!
  87.  
  88. Does it cost anything?
  89. ====================
  90. Nope. HeartQuest is *freeware* - free but copyrighted. Use it, give it away to friends, upload it to BBSs, etc. If you are a CD-ROM manufacturer or commercial shareware distributor, you may include HeartQuest only if you send me a sample of the final product (CD, book, magazine…).
  91.  
  92. Have you made other games?
  93. =========================
  94. Yes, quite a few. I offer all my games in two "shareware packs".
  95.  
  96. • Pack #1 goes for $15 and has Bachman (with editor) and Slime Invaders as the top items.
  97. • Pack #2 goes for $10, and has Ingemar's Skiing Game (with editor) and Bert on the top.
  98. (Both at once for $20.)
  99.  
  100. I am working on a few new titles, which will probably end up as Shareware Pack #3 some day. Not yet, though.
  101.  
  102. Final words
  103. ==========
  104.  
  105. My thanks to the testers, especially Dmitry Boldyrev who patiently went through several crashes before I had tracked down every flaw in the direct-to-screen drawing.
  106.  
  107. You can send opinions and bug reports to me over the Internet to the address ingemar@lysator.liu.se.
  108.  
  109. Snail mail address:
  110.  
  111. Ingemar Ragnemalm
  112. Plöjaregatan 73
  113. S-58333 Linköping
  114. SWEDEN
  115.